home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 September / Macworld (1998-09).dmg / Shareware World / Utilities / Disk & File / PW Disk Guard v2.5 (MOS) / Advanced Stuff / Dialog Director v0.7 / DD v0.7 (Read Me First) next >
Text File  |  1998-02-18  |  5KB  |  70 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11. Licence
  12.  
  13. Please note that this software is provided “as is” and without any express or implied warranties, including, without limitation, the implied warranties of merchantability and fitness for a particular purpose.
  14.  
  15. Dialog Director is FREE.  You may redistribute Dialog Director to anyone as long as you include the complete, unaltered, Dialog Director package and do not charge for it.
  16.  
  17. The “complete package” is defined as meaning the entire and exact contents of the file <http://www.hylight.demon.co.uk/DialogDirector/DialogDirector0.7.sit.hqx>.  It includes all scripting additions, all documentation and all examples & utilities, in either compressed or fully uncompressed form.  You may, of course, charge for your own software that uses Dialog Director (if you so desire), just not extra for Dialog Director.  It also means that you may not sell copies or redistribute parts of the Dialog Director package without obtaining a separate and specific licence from the author.
  18.  
  19. Although not a formal part of the licence I strongly suggest that if you use any URLs to Dialog Director at my website then you should use <http://www.hylight.demon.co.uk/DialogDirector/>.  Also I would sincerely appreciate being sent a complementary copy of any compilation CD that includes Dialog Director.
  20.  
  21. What is Dialog Director?
  22.  
  23. Dialog Director is a scripting addition that extends AppleScript and other OSA compatible languages on any computer running Mac OS 7 or later. It provides a rich set of features that allow you to create advanced and dynamic dialog boxes and floating windows directly from within your AppleScript scripts.  This gives you the ability to extend & customise an application’s user interface and to write applets, droplets & embedded scripts with the power to interact with your users in a fast, friendly, effective and professional manner.
  24.  
  25. Release Notes
  26.  
  27. Dialog Director v0.7 has many changes and new features.  Please read the User Guide. It is in MS Word 4 format, but any decent word processor should be able to open it.  It contains full details of the changes as well as all functions and features of Dialog Director along with script examples, descriptions of all the files in the “Examples” folder, instructions for using Dialog Dumper and other useful information.
  28.  
  29. This release also includes Resource Utilities v1.1b1 that resolves a couple of conflicts and adds the facility to access the resource forks of the current script and application and to keep a resource file in the access chain so that its resources are accessible to Dialog Director etc.
  30.  
  31. Updating from Dialog Director v0.6 to v0.7
  32.  
  33. Basically, DD v0.7 is not fully compatible with DD v0.6 nor is it backwards compatible with the older property names used in DD v0.5.  Scripts must be recompiled and updated to work correctly.  The update process is fairly simple, some of the changes will happen automagically just by recompiling the script.  The following procedure should take care of the rest.  Steps 9 & 10 are not essential to make the script function.
  34.  
  35. Note: You should, of course, backup your scripts and the Dialog Director v0.6 scripting addition before attempting any of this.
  36.  
  37. 1. Before replacing version 0.6 of the Dialog Director scripting addition make sure all your scripts have been saved with the “Compiled Script” setting in the Save/Save As dialog box.
  38.  
  39. 2. Quit your script editor.
  40.  
  41. 3. Replace version 0.6 of the Dialog Director scripting addition (in the Scripting Additions folder) with the new version 0.7 of the Dialog Director scripting addition.
  42.  
  43. 4. Load the script into your script editor and recompile it.  You may have to insert a space into the document (or make any change) to force it to recompile.
  44.  
  45. 5. Replace any occurrences of dd auto dialog … font FontSpec … with dd auto dialog … with fonts [FontSpec] ….
  46.  
  47. 6. Replace any occurrences of dd auto dialog … with floating with dd auto dialog … float above every app.
  48.  
  49. 7. Replace any occurrences of dd install font FontSpec … with dd install with fonts [FontSpec] ….
  50.  
  51. 8. Replace any occurrences of dd install … with floating with dd install … float above every app.
  52.  
  53. 9. Change the bounds:[left, top,right,bottom] of any labelled group box by decreasing top by 11 if the font used is 12pt Chicago and by 9 if the font used is either 9 or 10pt Geneva.  If the name: property starts and ends with a space then remove these two spaces.
  54.  
  55. 10. Read the User Guide for details about using the new, and preferred, global font table and font:index as opposed to font:FontSpec in all dialog item records.  Nearly all the example scripts (in the “Examples” folder) that use fonts make use of the global font table.
  56.  
  57. 11. Save then run the script.
  58.  
  59. The changes that should happen automagically are:
  60.  
  61. • Dialog items’ value:x               ‹ value:x.  (Looks the same but now compatible with Script Debugger.)
  62. • Dialog’s style:document window ‹ style:standard window.
  63. • Dialog’s style:modal                    ‹ style:standard dialog.
  64. • Dialog’s style:movable modal      ‹ style:movable dialog.
  65. • Dialog’s style:palette                   ‹ style:standard palette.
  66. • Dialog’s default:index                   ‹ default item:index.
  67. • Parameter greyscale                ‹ grayscale.
  68.  
  69. The full details can be found in the User Guide, DD’s dictionary and the example scripts.
  70.